home *** CD-ROM | disk | FTP | other *** search
XXXXTTTTPPPP((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((11110000 DDDDeeeecccceeeemmmmbbbbeeeerrrr 1111999999994444)))) XXXXTTTTPPPP((((1111)))) NNNNAAAAMMMMEEEE xtp - file transfer program SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS xxxxttttpppp [ -_o_p_t_i_o_n_s ... ] <_u_n_i_f_o_r_m _r_e_s_o_u_r_c_e _l_o_c_a_t_o_r> DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN _X_t_p is a utility for retrieving, listing, or printing files from a remote network site, or sending files to a remote network site. _x_t_p performs most of the same functions as the ffffttttpppp((((1111)))) program, but does not require any interactive commands. You simply specify the file transfer task on the command line and xxxxttttpppp performs the task automatically. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS To retrieve the file bbbbiiiirrrrdddd....jjjjppppgggg in directory iiiimmmmaaaaggggeeeessss from host wwwwiiiizzzzaaaarrrrdddd....dddduuuuppppoooonnnntttt....ccccoooommmm, use: xxxxttttpppp ffffttttpppp::::////////wwwwiiiizzzzaaaarrrrdddd....dddduuuuppppoooonnnntttt....ccccoooommmm////iiiimmmmaaaaggggeeeessss////bbbbiiiirrrrdddd....jjjjppppgggg To retrieve all the files from directory iiiimmmmaaaaggggeeeessss as user ccccrrrriiiissssttttyyyy from host wwwwiiiizzzzaaaarrrrdddd....dddduuuuppppoooonnnntttt....ccccoooommmm, use: xtp -retrieve ftp://cristy@wizard.dupont.com/images You will be prompted for a password. To retrieve all the files from directory iiiimmmmaaaaggggeeeessss as user ccccrrrriiiissssttttyyyy and password mmmmaaaaggggiiiicccckkkk from host wwwwiiiizzzzaaaarrrrdddd....dddduuuuppppoooonnnntttt....ccccoooommmm, use: xtp -retrieve ftp://cristy:magick@wizard.dupont.com/images OOOOPPPPTTTTIIIIOOOONNNNSSSS ----aaaaccccccccoooouuuunnnntttt _p_a_s_s_w_o_r_d Supply a supplemental password required by a remote system for access to resources. ----bbbbiiiinnnnaaaarrrryyyy retrieve files as binary. This is the default. Use ++++bbbbiiiinnnnaaaarrrryyyy to retrieve files as text. ----ddddiiiirrrreeeeccccttttoooorrrryyyy list the names of files and their attributes that match the filename component of the uniform resource locator. The filename component is processed as a regular expression. ----eeeexxxxcccclllluuuuddddeeee _e_x_p_r_e_s_s_i_o_n exclude files that match the regular _e_x_p_r_e_s_s_i_o_n. This option applies to the ----ddddiiiirrrreeeeccccttttoooorrrryyyy, ----pppprrrriiiinnnntttt, or Page 1 (printed 12/17/98) XXXXTTTTPPPP((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((11110000 DDDDeeeecccceeeemmmmbbbbeeeerrrr 1111999999994444)))) XXXXTTTTPPPP((((1111)))) ----rrrreeeettttrrrriiiieeeevvvveeee options. ----ffffiiiilllleeee _n_a_m_e store the file with this name. Refer to the ----ggggeeeetttt and ----ppppuuuutttt option for more details. ----ggggeeeetttt get files that match the filename component of the uniform resource locator. The filename component is expanded by passing it to ccccsssshhhh((((1111)))). This option is equivalent to using the ffffttttpppp ggggeeeetttt command. However, if the filename contains globbing characters this option is equivalent to the ffffttttpppp mmmmggggeeeetttt command. Without globbing characters, you can store the file locally with a different name by using the ----ffffiiiilllleeee option. ----ppppoooorrrrtttt _n_u_m_b_e_r If no port number is specified, xxxxttttpppp attempts to contact a FTP server at the default port. Otherwise, the specified port number is used. ----pppprrrrooooxxxxyyyy _h_o_s_t_n_a_m_e access the remote host via a proxy ffffttttppppdddd client running on this host. The default value of this option can be set with the environment variable xxxxttttpppp____pppprrrrooooxxxxyyyy. See EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT for more details. Use ++++pppprrrrooooxxxxyyyy to prevent proxy connections. ----pppprrrriiiinnnntttt print files that match the filename component of the uniform resource locator. The filename component is processed as a regular expression. ----pppprrrruuuunnnneeee process files in the remote directory specified by the directory component of the uniform resource locator. Do not recursively search for files. ----ppppuuuutttt put files that match the filename component of the uniform resource locator. The filename component is expanded by passing it to ccccsssshhhh((((1111)))). This option is equivalent to using the ffffttttpppp ppppuuuutttt command. However, if the filename contains globbing characters this option is equivalent to the ffffttttpppp mmmmppppuuuutttt command. Without globbing characters, you can store the file remotely with a different name by using the ----ffffiiiilllleeee option. Page 2 (printed 12/17/98) XXXXTTTTPPPP((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((11110000 DDDDeeeecccceeeemmmmbbbbeeeerrrr 1111999999994444)))) XXXXTTTTPPPP((((1111)))) ----rrrreeeettttrrrriiiieeeevvvveeee retrieve files that match the filename component of the uniform resource locator. The filename component is processed as a regular expression. Retrieved files are stored on your local host directory as the full name of the retrieved file. For example, if the retrieved file is named ddddooooccccuuuummmmeeeennnnttttssss////xxxxttttpppp....mmmmaaaannnn on the remote FTP server, it will appear in your remote directory as ddddooooccccuuuummmmeeeennnnttttssss////xxxxttttpppp....mmmmaaaannnn. ----ttttiiiimmmmeeeeoooouuuutttt _s_e_c_o_n_d_s specifies the maximum seconds to complete your remote FTP server request. If this time expires, the program terminates. The program also terminates if one tenth of this value is exceeded while logging onto the remote FTP server. ----ttttyyyyppppeeee _n_a_m_e identify the remote system type: UNIX, VMS, or other. The system type is determined automatically, however, you can override the system type with this option. ----vvvveeeerrrrbbbboooosssseeee show all responses from the remote server. If only the program name is specified on the command line, the program command syntax and options are listed. If neither ----ddddiiiirrrreeeeccccttttoooorrrryyyy, ----pppprrrriiiinnnntttt, ----ppppuuuutttt, or ----rrrreeeettttrrrriiiieeeevvvveeee are specified on the command line, the file or files specified by the uniform resource locator is retrieved from the remote network host (as if ----ggggeeeetttt was specified). <_u_n_i_f_o_r_m _r_e_s_o_u_r_c_e _l_o_c_a_t_o_r> has the format: protocol://host/[directory/[filename]] where protocol is ffffttttpppp and host is [[[[uuuusssseeeerrrr[[[[::::ppppaaaasssssssswwwwoooorrrrdddd]]]]]]]]@@@@hhhhoooossssttttnnnnaaaammmmeeee. User defaults to aaaannnnoooonnnnyyyymmmmoooouuuussss and password defaults to hhhhoooosssstttt....ddddoooommmmaaaaiiiinnnn. Note that ddddiiiirrrreeeeccccttttoooorrrryyyy////[[[[ffffiiiilllleeeennnnaaaammmmeeee]]]] is interpreted relative to the home directory for uuuusssseeeerrrr, thus an absolute pathname must be specified with the leading ////: ftp://host//tmp/anyfile As an extension, the filename part of the locator is expanded by the shell for options ----ggggeeeetttt or ----ppppuuuutttt, otherwise it is processed as a regular expression. For convenience, the protocol component of the uniform resource locator (ffffttttpppp::::////////) Page 3 (printed 12/17/98) XXXXTTTTPPPP((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((11110000 DDDDeeeecccceeeemmmmbbbbeeeerrrr 1111999999994444)))) XXXXTTTTPPPP((((1111)))) may be omitted. XXXXttttpppp retrieves files from the remote directory for ----ggggeeeetttt and puts files in the remote directory for ----ppppuuuutttt. Otherwise, xxxxttttpppp looks for a file of the form llllssss----llllllllssss----llll(((([[[[RRRRtttt]]]]))))++++(((([[[[RRRRtttt]]]]))))**** and assumes it contains a recursive directory listing. If none is found, xxxxttttpppp recursively descends the directory hierarchy from the remote directory. Some remote hosts may have thousands of files causing a significant delay satisfying your request. This can be wasteful if the files you are interested in reside in a known directory. You can reduce the searching required by specifying <_r_e_m_o_t_e _d_i_r_e_c_t_o_r_y> on the command line. This limits the filename search to the specified directory and any of its subdirectories. Alternatively, ----pppprrrruuuunnnneeee restricts the search to the remote directory only. RRRREEEEGGGGUUUULLLLAAAARRRR EEEEXXXXPPPPRRRREEEESSSSSSSSIIIIOOOONNNNSSSS A _r_e_g_u_l_a_r _e_x_p_r_e_s_s_i_o_n is zero or more branches, separated by ||||. It matches anything that matches one of the branches. A branch is zero or more pieces, concatenated. It matches a match for the first, followed by a match for the second, etc. A piece is an atom possibly followed by ****, ++++, or ????. An atom followed by **** matches a sequence of 0 or more matches of the atom. An atom followed by ++++ matches a sequence of 1 or more matches of the atom. An atom followed by ???? matches a match of the atom, or the null pattern. An atom is a _r_e_g_u_l_a_r _e_x_p_r_e_s_s_i_o_n in parentheses (matching a match for the _r_e_g_u_l_a_r _e_x_p_r_e_s_s_i_o_n), a range (see below), .... (matching any single character), ^^^^ (matching the null pattern at the beginning of the input pattern), $$$$ (matching the null pattern at the end of the input pattern), a '''' followed by a single character (matching that character), or a single character with no other significance (matching that character). A range is a sequence of characters enclosed in [[[[]]]]. It normally matches any single character from the sequence. If the sequence begins with ^^^^, it matches any single character not from the rest of the sequence. If two characters in the sequence are separated by ----, this is shorthand for the full list of ASCII characters between them (e.g. [[[[0000----9999]]]] matches any decimal digit). To include a literal ]]]] in the sequence, make it the first character (following a possible ^^^^). To include a literal ----, make it the first or last character. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT xxxxttttpppp____pppprrrrooooxxxxyyyy Page 4 (printed 12/17/98) XXXXTTTTPPPP((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((11110000 DDDDeeeecccceeeemmmmbbbbeeeerrrr 1111999999994444)))) XXXXTTTTPPPP((((1111)))) Specifies that the remote site should be contacted by proxy. See ----pppprrrrooooxxxxyyyy. FFFFIIIILLLLEEEESSSS ~~~~////....nnnneeeettttrrrrcccc SSSSEEEEEEEE AAAALLLLSSSSOOOO ffffttttpppp((((1111CCCC)))),,,, MMMMoooossssaaaaiiiicccc((((1111)))) CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT Copyright 1998 E. I. du Pont de Nemours and Company Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files ("ImageMagick"), to deal in ImageMagick without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of ImageMagick, and to permit persons to whom the ImageMagick is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of ImageMagick. The software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall E. I. du Pont de Nemours and Company be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with ImageMagick or the use or other dealings in ImageMagick. Except as contained in this notice, the name of the E. I. du Pont de Nemours and Company shall not be used in advertising or otherwise to promote the sale, use or other dealings in ImageMagick without prior written authorization from the E. I. du Pont de Nemours and Company. AAAACCCCKKKKNNNNOOOOWWWWLLLLEEEEDDDDGGGGEEEEMMMMEEEENNNNTTTTSSSS Steve Singles, University of Delaware, for the initial implementation of this program. Henry Spencer, University of Toronto, for the implementation of the _r_e_g_u_l_a_r _e_x_p_r_e_s_s_i_o_n interpreter and the text in RRRREEEEGGGGUUUULLLLAAAARRRR EEEEXXXXPPPPRRRREEEESSSSSSSSIIIIOOOONNNNSSSS. AAAAUUUUTTTTHHHHOOOORRRR John Cristy, E.I. DuPont De Nemours and Company Incorporated Page 5 (printed 12/17/98) 
